Installing the Evisions Delivery App

You will receive a zip file that contains the Evisions Delivery App (EvisionsDeliveryApp.jar), and the .bat file (run.bat). Place the zip file in a directory (example: C:\eda), and extract. Run the .bat file to execute the Evisions Delivery App.

Prerequisites

The Evisions Delivery App must be installed on a Windows server.

It is recommended to install the Evisions Delivery App on the same server where the Banner Print App is installed.

Important: Java 17 or higher must be installed prior to running the Evisions Delivery App.

When running the file, you may receive a warning about the file coming from an unknown publisher. This behavior is expected and the file is safe to execute. If the file is unable to execute, navigate to the file properties and check the Unblock checkbox.

When the Evisions Delivery App runs for the first time, the eda.properties file will be created, and you will see this error message:

Message recieved while installing the EDA.

This message is expected and can be ignored.

From here the file will need to be configured. The information required in the eda.properties file includes: maps.username, maps.password, maps.host, and maps.https.port.

There are other optional configurable properties (example: logging, email logging, etc) that may be changed if desired.

The Evisions Delivery App log files are located in the same directory as the eda.properties file under the logs directory.

Troubleshooting

SSLHandshakeException Error Message

Possible error.

You may receive an error message regarding a failed SSL verification when running the Evisions Delivery App. There are two options to address this issue:

Add the SSL certificate to the Java Keystore and restart the application. This is the recommended option.

Modify the eda.properties file and set the value as "1" for the maps.ssl.trustall property.

Warning: this will cause the Evisions Delivery App to trust all SSL certificates. After modifying the eda.properties file, be sure to restart the Evisions Delivery App.

MissingFormatArgumentException Error Message

The Evisions Delivery App may receive an error when polling MAPS: (MissingFormatArgumentException) Format Specifier '%s'. Jobs won't run while in this state and a restart of the Evisions Delivery App is required.